home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 July / Amiga Games 1996 #7.iso / c / sort.doc < prev    next >
Text File  |  1995-02-07  |  4KB  |  118 lines
  1.  
  2.                File Sorting Utility 1.3 -- Replacement of C:Sort
  3.  
  4.                  (c) 1995 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    FSort,  its  documentation and the ss.library are Copyright (c) Martin Mares,
  13. MJSoft System Software, Prague, Czech Republic.
  14.  
  15.    This  archive  can  be  freely  redistributed as long as all of its files are
  16. included   in   their   original   form  without  any  additions,  deletions  or
  17. modifications  (excluding addition of other README-style files and icons) and no
  18. more  than a nominal fee is charged for its distribution.  All copyright notices
  19. in  the  programs and accompanying documentation files must remain intact.  It's
  20. especially  forbidden  to add various '.displayme' files and BBS advertisements.
  21. This style of distribution is generally known as FREEWARE.
  22.  
  23.    Source  text of this program is included in the distribution.  You can freely
  24. improve  it.   If  you  want  to  distribute your improved version, there're two
  25. possibilities:   (1)  Send  your  improvements  to  me  (the best form is a diff
  26. output)  and  I'll include them in the next release.  (2) Distribute them alone.
  27. In  this  case, you must mention the name of original author, change the name of
  28. the  product  (not  only  by  increasing  the  version),  and  obey  all  of the
  29. distribution rules mentioned above.
  30.  
  31.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  32. expressed  or  implied.   The author is not responsible for any damage caused by
  33. it.
  34.  
  35.  
  36. Introduction
  37. ============
  38.  
  39.    File sorting... Hmm... C:Sort does this... But it's very sssslllllooooowwwww.
  40. ARP Sort sorts slightly faster.
  41.  
  42.    - FSort tries to be much more better.
  43.  
  44.    - FSort supports input from stdin and output to stdout (PIPES !!!).
  45.  
  46.    - FSort eats less RAM (but slightly more than ARP Sort).
  47.  
  48.    - FSort requires Kickstart 2.04 or higher.
  49.  
  50.    - FSort is pure and can be made resident.
  51.  
  52.    - FSort takes advantage of the powerful ss.library (also in this archive,
  53. see SSLib??.lha on the AmiNet for complete distribution).
  54.  
  55.    Speed comparison: (280K file, on GVP A530 Turbo - 68EC030 40MHz)
  56.  
  57.       original C:Sort 37.3    36 seconds    380K used
  58.       ARP Sort            27 seconds    317K used
  59.       FSort            4.9 seconds    334K used
  60.  
  61.    All the timings are mesaured by Stat 1.0 (available in MJUtils.lha on AmiNet).
  62.  
  63.  
  64. Usage
  65. =====
  66.  
  67.    FSort must be started from the shell.
  68.  
  69. Syntax: FSort [<source> [<dest>]] [CASE] [BUF <bufsize>] [COLSTART <c>]
  70.               [WIDTH <w>]
  71.  
  72.    source - source file (standard input if omitted)
  73.      dest - destination file (standard output if omitted)
  74.      CASE - perform case-dependent sorting (it may be faster a lot)
  75.       BUF - set I/O buffer size in bytes (default: 8192). Maximal allowed line
  76.             length is equal to approximately one half of this size.
  77.  COLSTART - byte offset on the line the comparison starts from (0=leftmost)
  78.     WIDTH - width of line part the comparison is applied to
  79.  
  80.    Destination identical to source is allowed.
  81.  
  82.  
  83. Speed
  84. =====
  85.  
  86.    This paragraph describes how various options affect sorting speed. All the
  87. timings (477K file, on GVP A530 Turbo - 68EC030 40MHz, measured by Stat 1.0):
  88.  
  89.    Default        6.99 sec
  90.    CASE            5.65 sec
  91.    COLSTART/WIDTH    7.63 sec
  92.    CASE+COLSTART/WIDTH    6.19 sec
  93.  
  94.  
  95. History
  96. =======
  97.  
  98. Version 1.2 (16 Jan 1995)
  99.  
  100.    - BUF option added to allow processing of very long lines.
  101.  
  102.    - Corrected sorting of files with more than 65535 lines. If you need to sort
  103.      such files, you must use ss.library version 5.1 or newer (version 5.1 is
  104.      included in this archive).
  105.  
  106. Version 1.3 (7 Feb 1995)
  107.  
  108.    - COLSTART and WIDTH options implemented.
  109.  
  110.    - Speed statistics added to the DOC.
  111.  
  112.  
  113. Notes
  114. =====
  115.  
  116.    Send suggestions, flames and bug reports to <mjsoft@k332.feld.cvut.cz>.
  117.  
  118.